第1天 ( 2026年8月2日 星期日 ) 購買 Google AI Pro , 超級感謝萬能的天神 Google 有聽到我的許願,讓我能夠以 NT$160 購買三個月,很希望我不會讓我最敬愛的 Google 失望,我想在這三個月內盡力去完成我一直掛念想要將考國際證照的應用程式變成開源且人人都可以免費使用且可完全離線的多平台應用程式 ( Android , WEB , Mac , iPhone , Linux , Windows ...等 ) .
同時也非常感謝 Thursday, July 30, 2026
[Build on Google AI] - 2026 iThome 鐵人賽說明會與實戰工作坊 ( https://gdg.community.dev/events/details/google-gdg-cloud-taipei-presents-build-on-google-ai-2026-ithome-tie-ren-sai-shuo-ming-hui-yu-shi-zhan-gong-zuo-fang/ ) , 當天在 Taipei 101, 7 Section 5, Xinyi Road, Xinyi District 110 , 23樓的指導老師,工作人員及現場每一位人員,雖然我現在還未收到 30 天的 Google Skills 優惠,但是希望我會努力完成連續 30 天鐵人賽.

MockExam-CCNA 開源文件套件 — 完整實作計畫

目標

為 MockExam-CCNA 應用程式建立一套完整、雙語（EN / zh-TW）、通用化的專業開源文件套件，涵蓋 PRD、SDD、BDD、Test Spec、UI/UX、API 整合、部署運維、資料庫遷移、AI Agent 指南、架構決策記錄（ADR），以及 GitHub 開源專案標準配套檔案。

文件的核心目標：

1. AI Agent 可執行層：讓任何全新的 AI Agent（Antigravity、Gemini CLI 等）能從零開始，僅依靠這些文件自主重建出一個功能完整的類似 App。
2. 人類可讀教學層：讓完全不懂電腦的人也能理解系統的功能與行為；同時滿足專業開發者的技術深度需求。
3. 通用模板：不綁定特定考試領域（CCNA），使用者可將「考試題庫」替換為任何他們想要的領域。

訪談決策摘要

資料夾結構

docs/
├── INDEX.md                              ← 文件套件總索引與導航地圖
│
├── 01-prd/                               ← 產品需求文件
│   ├── en/
│   │   └── PRD.md
│   └── zh-TW/
│       └── PRD.md
│
├── 02-sdd/                               ← 系統設計文件（拆分為多個子文件）
│   ├── en/
│   │   ├── 01-system-overview.md
│   │   ├── 02-architecture.md
│   │   ├── 03-data-models.md
│   │   ├── 04-database-design.md
│   │   ├── 05-security-architecture.md
│   │   ├── 06-ai-engine.md
│   │   ├── 07-offline-sync.md
│   │   ├── 08-payment-system.md
│   │   ├── 09-state-management.md
│   │   ├── 10-ui-components.md
│   │   └── 11-automation-scripts.md
│   └── zh-TW/
│       └── (同上結構)
│
├── 03-bdd/                               ← 行為驅動開發場景（Gherkin .feature 檔）
│   ├── en/
│   │   ├── auth.feature
│   │   ├── exam-practice.feature
│   │   ├── mock-exam.feature
│   │   ├── wrong-questions.feature
│   │   ├── ai-tutor.feature
│   │   ├── payment-subscription.feature
│   │   ├── admin-panel.feature
│   │   ├── security.feature
│   │   ├── search.feature
│   │   ├── localization.feature
│   │   ├── tts-voice.feature
│   │   └── notes.feature
│   └── zh-TW/
│       └── (同上結構)
│
├── 04-test-spec/                         ← 測試規格文件
│   ├── en/
│   │   ├── 01-test-strategy.md
│   │   ├── 02-unit-tests.md
│   │   ├── 03-widget-tests.md
│   │   ├── 04-integration-tests.md
│   │   ├── 05-e2e-tests.md
│   │   └── 06-test-matrix.md
│   └── zh-TW/
│       └── (同上結構)
│
├── 05-ui-ux/                             ← UI/UX 設計規格
│   ├── en/
│   │   ├── 01-design-system.md
│   │   ├── 02-screen-specifications.md
│   │   └── 03-interaction-patterns.md
│   └── zh-TW/
│       └── (同上結構)
│
├── 06-api-integration/                   ← API 與外部服務整合指南
│   ├── en/
│   │   ├── 01-firebase-setup.md
│   │   ├── 02-supabase-setup.md
│   │   ├── 03-mongodb-setup.md
│   │   ├── 04-powersync-setup.md
│   │   ├── 05-revenuecat-setup.md
│   │   ├── 06-admob-setup.md
│   │   ├── 07-crashlytics-shake-setup.md
│   │   └── 08-ai-api-setup.md
│   └── zh-TW/
│       └── (同上結構)
│
├── 07-deployment/                        ← 部署與運維手冊
│   ├── en/
│   │   ├── 01-environment-setup.md
│   │   ├── 02-build-configuration.md
│   │   ├── 03-android-deployment.md
│   │   ├── 04-web-deployment.md
│   │   ├── 05-secrets-management.md
│   │   └── 06-ci-cd-automation.md
│   └── zh-TW/
│       └── (同上結構)
│
├── 08-database/                          ← 資料庫遷移與種子資料指南
│   ├── en/
│   │   ├── 01-schema-setup.md
│   │   ├── 02-seed-data.md
│   │   ├── 03-ai-classification.md
│   │   └── 04-sync-operations.md
│   └── zh-TW/
│       └── (同上結構)
│
├── 09-agents/                            ← AI Agent 專用指南
│   ├── en/
│   │   └── AGENTS.md
│   └── zh-TW/
│       └── AGENTS.md
│
├── 10-adr/                               ← 架構決策記錄
│   ├── en/
│   │   ├── 001-multi-database-architecture.md
│   │   ├── 002-offline-first-sync-strategy.md
│   │   ├── 003-dual-ai-engine-design.md
│   │   ├── 004-dual-payment-provider.md
│   │   ├── 005-security-first-design.md
│   │   └── 006-role-based-access-control.md
│   └── zh-TW/
│       └── (同上結構)
│
└── 11-open-source/                       ← GitHub 開源專案配套文件
    ├── README.md                         ← 專案介紹模板（雙語）
    ├── QUICKSTART.md                     ← 5 分鐘快速上手（雙語）
    ├── CONTRIBUTING.md                   ← 貢獻指南（雙語）
    ├── CODE_OF_CONDUCT.md                ← 社群行為準則（雙語）
    ├── SECURITY.md                       ← 安全漏洞通報流程（雙語）
    ├── CHANGELOG.md                      ← 版本更新日誌模板（雙語）
    └── LICENSE                           ← Apache 2.0 授權條款

預估文件總數：約 105 個檔案（含雙語版本）

各文件詳細章節結構與內容概要

📄 INDEX.md — 文件套件總索引

用途：作為所有文件的入口與導航地圖，提供雙語連結。

📄 01-prd/PRD.md — 產品需求文件

用途：定義產品的商業目標、使用者故事、功能需求與非功能需求。讓任何人理解「這個 App 要解決什麼問題」。

📄 02-sdd/ — 系統設計文件（11 個子文件）

01-system-overview.md

02-architecture.md

03-data-models.md

04-database-design.md

05-security-architecture.md

06-ai-engine.md

07-offline-sync.md

08-payment-system.md

09-state-management.md

10-ui-components.md

11-automation-scripts.md

📄 03-bdd/ — 行為驅動開發場景（12 個 .feature 檔）

每個 .feature 檔案的概要：

預估場景總數：~147 個 Scenario

📄 04-test-spec/ — 測試規格文件（6 個子文件）

01-test-strategy.md

02-unit-tests.md

03-widget-tests.md

04-integration-tests.md

05-e2e-tests.md

06-test-matrix.md

📄 05-ui-ux/ — UI/UX 設計規格（3 個子文件）

01-design-system.md

02-screen-specifications.md

03-interaction-patterns.md

📄 06-api-integration/ — 外部服務整合指南（8 個子文件）

每個整合指南包含：

1. 帳號申請步驟（含連結）
2. 控制台設定步驟（帶截圖描述）
3. SDK 安裝與配置（pubspec.yaml、gradle、info.plist）
4. 程式碼整合重點（初始化、API 呼叫、錯誤處理）
5. 環境變數對照表（需要設定哪些 Key）
6. 常見問題排除

📄 07-deployment/ — 部署與運維手冊（6 個子文件）

01-environment-setup.md

02-build-configuration.md

03-android-deployment.md / 04-web-deployment.md

05-secrets-management.md

06-ci-cd-automation.md

📄 08-database/ — 資料庫遷移與種子資料（4 個子文件）

01-schema-setup.md

02-seed-data.md

03-ai-classification.md

04-sync-operations.md

📄 09-agents/AGENTS.md — AI Agent 專用指南

與現有 .agents/AGENTS.md 的區別：這是通用化版本，供開源專案的使用者在自己的 Agent 環境中使用。

📄 10-adr/ — 架構決策記錄（6 個 ADR）

每個 ADR 遵循標準格式：

# ADR-XXX: [決策標題]
## 狀態：已接受
## 背景
## 決策
## 備選方案（含利弊分析）
## 後果

📄 11-open-source/ — GitHub 開源專案配套（7 個檔案）

執行策略

由於文件量龐大（105+ 檔案），建議按以下優先順序分批執行：

第一批：核心骨架（最高優先）

1. INDEX.md — 總索引
2. 01-prd/ — PRD（EN + zh-TW）
3. 02-sdd/01-system-overview.md — 系統總覽
4. 02-sdd/02-architecture.md — 架構設計
5. 02-sdd/03-data-models.md — 資料模型
6. 09-agents/AGENTS.md — AI Agent 指南

第二批：技術深度

7. 02-sdd/04-database-design.md — 資料庫設計
8. 02-sdd/05-security-architecture.md — 安全架構
9. 02-sdd/06-ai-engine.md — AI 引擎
10. 02-sdd/07-offline-sync.md — 離線同步
11. 02-sdd/08-payment-system.md — 付費系統

第三批：行為與測試

12. 03-bdd/ — 所有 BDD 場景
13. 04-test-spec/ — 所有測試規格

第四批：整合與部署

14. 06-api-integration/ — 外部服務整合
15. 07-deployment/ — 部署運維
16. 08-database/ — 資料庫遷移

第五批：補充文件

17. 02-sdd/09~11 — 剩餘 SDD 子文件
18. 05-ui-ux/ — UI/UX 設計規格
19. 10-adr/ — 架構決策記錄
20. 11-open-source/ — 開源配套

驗證計畫

自動化驗證

• markdownlint 檢查所有 .md 檔案的格式
• gherkin-lint 驗證所有 .feature 檔案的語法正確性
• Mermaid 語法驗證（確保 GitHub 可正確渲染）
• 連結有效性檢查（確保文件間交叉引用正確）

人工驗證

• 請使用者審閱每一批文件的完整性與正確性
• 確認通用化替換（去除 CCNA 綁定）的徹底性
• 確認雙語翻譯的一致性與專業度

[!IMPORTANT]
預估工作量：此文件套件包含約 105 個檔案，內容涵蓋完整的產品、架構、行為、測試、整合與部署規格。建議分 5 批次執行，每批完成後由您審閱確認再進入下一批。

請確認此計畫是否符合您的需求，或是否有任何章節需要調整、新增或刪除。

[!NOTE]
由於文件量非常龐大，建議使用 /goal 指令來執行，以確保 Agent 能夠持續工作直到完成整個文件套件。

我使用 Google Antigravity 的 task.md 內容如下

MockExam-CCNA 開源文件套件 — 任務追蹤

第一批：核心骨架 ✅ 已完成

• [x] docs/INDEX.md — 總索引與導航地圖
• [x] docs/01-prd/en/PRD.md — 產品需求文件（EN）
• [x] docs/01-prd/zh-TW/PRD.md — 產品需求文件（zh-TW）
• [x] docs/02-sdd/en/01-system-overview.md — 系統總覽（EN）
• [x] docs/02-sdd/zh-TW/01-system-overview.md — 系統總覽（zh-TW）
• [x] docs/02-sdd/en/02-architecture.md — 架構設計（EN）
• [x] docs/02-sdd/zh-TW/02-architecture.md — 架構設計（zh-TW）
• [x] docs/02-sdd/en/03-data-models.md — 資料模型（EN）
• [x] docs/02-sdd/zh-TW/03-data-models.md — 資料模型（zh-TW）
• [x] docs/09-agents/en/AGENTS.md — AI Agent 指南（EN）
• [x] docs/09-agents/zh-TW/AGENTS.md — AI Agent 指南（zh-TW）

第二批：技術深度 🔄 進行中

• [/] docs/02-sdd/en/04-database-design.md — 資料庫設計（EN）
• [/] docs/02-sdd/zh-TW/04-database-design.md — 資料庫設計（zh-TW）
• [/] docs/02-sdd/en/05-security-architecture.md — 安全架構（EN）
• [/] docs/02-sdd/zh-TW/05-security-architecture.md — 安全架構（zh-TW）
• [/] docs/02-sdd/en/06-ai-engine.md — AI 引擎（EN）
• [/] docs/02-sdd/zh-TW/06-ai-engine.md — AI 引擎（zh-TW）
• [/] docs/02-sdd/en/07-offline-sync.md — 離線同步（EN）
• [/] docs/02-sdd/zh-TW/07-offline-sync.md — 離線同步（zh-TW）
• [/] docs/02-sdd/en/08-payment-system.md — 付費系統（EN）
• [/] docs/02-sdd/zh-TW/08-payment-system.md — 付費系統（zh-TW）

第三批：行為與測試

• [ ] docs/03-bdd/en/ — 12 個 .feature 檔 (EN)
• [ ] docs/03-bdd/zh-TW/ — 12 個 .feature 檔 (zh-TW)
• [ ] docs/04-test-spec/en/ — 6 個測試規格檔 (EN)
• [ ] docs/04-test-spec/zh-TW/ — 6 個測試規格檔 (zh-TW)

第四批：整合與部署

• [ ] docs/06-api-integration/en/ — 8 個整合指南 (EN)
• [ ] docs/06-api-integration/zh-TW/ — 8 個整合指南 (zh-TW)
• [ ] docs/07-deployment/en/ — 6 個部署手冊 (EN)
• [ ] docs/07-deployment/zh-TW/ — 6 個部署手冊 (zh-TW)
• [ ] docs/08-database/en/ — 4 個資料庫指南 (EN)
• [ ] docs/08-database/zh-TW/ — 4 個資料庫指南 (zh-TW)

第五批：補充文件

• [ ] docs/02-sdd/en/09-state-management.md
• [ ] docs/02-sdd/zh-TW/09-state-management.md
• [ ] docs/02-sdd/en/10-ui-components.md
• [ ] docs/02-sdd/zh-TW/10-ui-components.md
• [ ] docs/02-sdd/en/11-automation-scripts.md
• [ ] docs/02-sdd/zh-TW/11-automation-scripts.md
• [ ] docs/05-ui-ux/en/ — 3 個 UI/UX 設計規格 (EN)
• [ ] docs/05-ui-ux/zh-TW/ — 3 個 UI/UX 設計規格 (zh-TW)
• [ ] docs/10-adr/en/ — 6 個 ADR (EN)
• [ ] docs/10-adr/zh-TW/ — 6 個 ADR (zh-TW)
• [ ] docs/11-open-source/ — 7 個開源配套檔案

今天 task.md 進度如下:

MockExam-CCNA 開源文件套件 — 任務追蹤

第一批：核心骨架 ✅ 已完成

• [x] docs/INDEX.md — 總索引與導航地圖
• [x] docs/01-prd/en/PRD.md — 產品需求文件（EN）
• [x] docs/01-prd/zh-TW/PRD.md — 產品需求文件（zh-TW）
• [x] docs/02-sdd/en/01-system-overview.md — 系統總覽（EN）
• [x] docs/02-sdd/zh-TW/01-system-overview.md — 系統總覽（zh-TW）
• [x] docs/02-sdd/en/02-architecture.md — 架構設計（EN）
• [x] docs/02-sdd/zh-TW/02-architecture.md — 架構設計（zh-TW）
• [x] docs/02-sdd/en/03-data-models.md — 資料模型（EN）
• [x] docs/02-sdd/zh-TW/03-data-models.md — 資料模型（zh-TW）
• [x] docs/09-agents/en/AGENTS.md — AI Agent 指南（EN）
• [x] docs/09-agents/zh-TW/AGENTS.md — AI Agent 指南（zh-TW）

第二批：技術深度 🔄 進行中

• [/] docs/02-sdd/en/04-database-design.md — 資料庫設計（EN）
• [/] docs/02-sdd/zh-TW/04-database-design.md — 資料庫設計（zh-TW）
• [/] docs/02-sdd/en/05-security-architecture.md — 安全架構（EN）
• [/] docs/02-sdd/zh-TW/05-security-architecture.md — 安全架構（zh-TW）
• [/] docs/02-sdd/en/06-ai-engine.md — AI 引擎（EN）
• [/] docs/02-sdd/zh-TW/06-ai-engine.md — AI 引擎（zh-TW）
• [/] docs/02-sdd/en/07-offline-sync.md — 離線同步（EN）
• [/] docs/02-sdd/zh-TW/07-offline-sync.md — 離線同步（zh-TW）
• [/] docs/02-sdd/en/08-payment-system.md — 付費系統（EN）
• [/] docs/02-sdd/zh-TW/08-payment-system.md — 付費系統（zh-TW）

第三批：行為與測試

• [ ] docs/03-bdd/en/ — 12 個 .feature 檔 (EN)
• [ ] docs/03-bdd/zh-TW/ — 12 個 .feature 檔 (zh-TW)
• [ ] docs/04-test-spec/en/ — 6 個測試規格檔 (EN)
• [ ] docs/04-test-spec/zh-TW/ — 6 個測試規格檔 (zh-TW)

第四批：整合與部署

• [ ] docs/06-api-integration/en/ — 8 個整合指南 (EN)
• [ ] docs/06-api-integration/zh-TW/ — 8 個整合指南 (zh-TW)
• [ ] docs/07-deployment/en/ — 6 個部署手冊 (EN)
• [ ] docs/07-deployment/zh-TW/ — 6 個部署手冊 (zh-TW)
• [ ] docs/08-database/en/ — 4 個資料庫指南 (EN)
• [ ] docs/08-database/zh-TW/ — 4 個資料庫指南 (zh-TW)

第五批：補充文件

• [ ] docs/02-sdd/en/09-state-management.md
• [ ] docs/02-sdd/zh-TW/09-state-management.md
• [ ] docs/02-sdd/en/10-ui-components.md
• [ ] docs/02-sdd/zh-TW/10-ui-components.md
• [ ] docs/02-sdd/en/11-automation-scripts.md
• [ ] docs/02-sdd/zh-TW/11-automation-scripts.md
• [ ] docs/05-ui-ux/en/ — 3 個 UI/UX 設計規格 (EN)
• [ ] docs/05-ui-ux/zh-TW/ — 3 個 UI/UX 設計規格 (zh-TW)
• [ ] docs/10-adr/en/ — 6 個 ADR (EN)
• [ ] docs/10-adr/zh-TW/ — 6 個 ADR (zh-TW)
• [ ] docs/11-open-source/ — 7 個開源配套檔案